home *** CD-ROM | disk | FTP | other *** search
/ Software Vault: The Gold Collection / Software Vault - The Gold Collection (American Databankers) (1993).ISO / cdr35 / ckp101.zip / CKPACK.DOC < prev    next >
Text File  |  1993-06-08  |  4KB  |  84 lines

  1. -------------------------------------------------------------------------------
  2.   CKPACK.EXE  --  quick little utility to check the callers log for packing
  3.   Written by: Robert Vostreys, FTL Sysop, 404-292-8761; 296-3120; 299-3930
  4.   Released to the Public Domain on Sat Jun 05 1993;  .CPP source included.
  5. -------------------------------------------------------------------------------
  6.   Released as 1.01 (CKP101.ZIP) due to additional of sample .CFG's for
  7.   MarkMail (CK_MMAIL.CFG) and Qmail (CK_QMAIL.CFG) doors.
  8. -------------------------------------------------------------------------------
  9.  
  10.   Roger Sligar asked me to write a quick utility to check the callers log to
  11.   find out what conferences had messages left in them by MarkMail.  This is
  12.   needed so that a call to PCBPACK can be made FOR THAT CONFERENCE without
  13.   having to pack ALL of your conferences.  This program does only minimal
  14.   error checking, so use it at your own risk!  Sourcecode is included so you
  15.   can see exactly what it's doing (which is very straight forward).
  16.  
  17.   Syntax:  CKPACK.EXE ckpack.cfg
  18.  
  19.   CKPACK should be run from your PCB directory if it is to make calls to
  20.   PCBPACK (since PCBPACK wants to be in the PCB directory).
  21.  
  22.   Example $$LOGOFF.BAT file (which is where you should call CKPACK from):
  23.     ┌─
  24.     │ @echo off
  25.     │ offhook COM1   ; use whatever you prefer, I included a quickie I wrote
  26.     │ CKPACK CKPACK.CFG
  27.  
  28.   Contents of CKPACK.CFG needs to be:
  29.     Line 1: full filename of callers log to check (including node number)
  30.     Line 2: text to search for in last callers' log entries
  31.     Line 3: command to run for each conference; use %u to get the number
  32.  
  33.   Example CKPACK.CFG:
  34.     ┌─
  35.     │ k:\pcb\stats\caller5
  36.     │ thru MarkMail
  37.     │ pcbpack /area:%u /index /oldindex /nocaller /killbak /fast /quiet
  38.  
  39.   NOTE!  There can only be ONE '%' character in line 3 and it must be part of
  40.   '%u'.  I'm just dumping the line given to sprintf(), so it is very easy to
  41.   have a garbled command if additional %'s are there or not using %u!
  42.  
  43.   NOTE!  If you include the /UPDATE param to PCBPACK, you will only update the
  44.   IDX files and *only* if PCBPACK happens to think they are "short". Therefor,
  45.   and since it's not very good at catching problems, do not use it.
  46.  
  47.   When CKPACK looks at the callers log, and it finds the "thru MarkMail" (not
  48.   case sensitive), it looks around in that line for a "(####)".  The number in
  49.   ()'s is used as the conference number that CKPACK needs to make a packing
  50.   call for.  If no ()'s are present or does not contain a number, nothing
  51.   happens.
  52.  
  53.   Only ONE call is made to PCBPACK for each conference found that needs to be
  54.   updated.  Thus, if 50 messages are left in conference (1), only one pack is
  55.   needed.  This is done by using a large character string as a bunch of flags.
  56.  
  57.   I used the system() function to execute the third line, so a command.com
  58.   shell will be loaded.  You could use this to do an "echo ..." statement and/
  59.   or redirect the output using ">>output.fil".
  60.  
  61.   If running multi-node *and* you are using the same \PCB directory, you will
  62.   likely need a CKPACK.CFG for each node (so the callers log number can be
  63.   specified correctly).  Simply create CKPACK1.CFG, CKPACK2.CFG... etc with
  64.   different node numbers appended to the callers log filename, then, use:
  65.   CKPACK CKPACK%pcbnode%.CFG
  66.  
  67. -------------------------------------------------------------------------------
  68.  
  69.   NOTE: Qmail v4 (beta) that supports the IDX has a bug where it will *not*
  70.   always update the IDX file (sigh).  Until a fix is available, you will need
  71.   to use CKPACK (or some other means) to re-index your messagebases after a
  72.   user enters a message via QMail.
  73.  
  74. -------------------------------------------------------------------------------
  75.   If you have any questions or problems, please contact me (Robert Vostreys):
  76.       Faster-Than-Light     404-292-8761  [3/12/24]
  77.         (FTL)               404-296-3120  [HST1440]
  78.                             404-299-3930  [v.32bis]
  79.  
  80.   Roger Sligar can likely also answer of your questions:
  81.       The Right Place<tm>   404-476-2607  [HST/DS]
  82.         (TRP)               404-476-0847  [HST/DS]
  83. -------------------------------------------------------------------------------
  84.